1.4 Installation de Git

La première étape consiste à installer Git sur votre ordinateur.

Cela se fait très simplement quelque soit le système d’exploitation de votre machine. Il suffit de suivre les instructions parfaitement détaillées en français sur la page d’installation de Git

1.5 Création d’un compte Github

Il s’agit d’un passage obligé. Si ce fonctionnement peut faire, à raison, penser à celui d’un réseau social, rassurez-vous, les règles de la propriété intellectuelle sont très claires, et vous choisirez les projets à rendre public ou privé, ainsi que les collaborateurs à associer à chaque dépôt.

La création d’un compte se fait de manière tout à fait classique :

1. Rendez-vous sur le site de Github
2. Cliquez sur sign up en haut à droite
3. Remplissez les champs demandés

1.6 Créer un nouveau dépôt Github

Une fois connecté.e à Github, vous arrivez sur la page de votre profil.

Pour créer un dépot² rendez-vous sur la section Repositories via le bandeau.

Cette page recence tous les répertoires associés à votre compte, si vous venez de vous créer un compte, elle devrait donc être vide, sinon vous retrouverez ici tous vos différents dépôts. Pour en créer un, il suffit de cliquer sur new.

C’est sur cette page -à laquelle vous venez d’accéder après avoir cliqué sur new - que vous allez véritablement créer votre nouveau dépôt : lui donner un nom, déterminer son statut privé ou public, en organiser le contenu…

Après avoir cliqué sur Create repository vous aurez donc créé avec succès un nouveau dépôt Github et devriez voir une nouvelle page s’afficher à l’écran, présentant les principales étapes à suivre pour l’ajout de contenu par le biais d’informations textuelles et de lignes de code.

1.7 Importer des éléments dans votre répertoire Github depuis votre ordinateur

Pour réaliser cet import, vous allez temporairement laisser Github de côté.

Vous avez donc réalisé en local votre fiche Rzine, et disposez d’un dossier contenant tous les différents éléments. L’objectif est donc d’importer facilement ce dossier (dans son intégralité) dans votre répertoire GitHub en utilisant Git et ses lignes de commande classiques.

1- Il vous faut en premier lieu ouvrir votre terminal ou invite de commandes

C’est la façon la plus efficace d’interagir avec Github depuis votre ordinateur. De prime abord, l’interface d’interprétation de commandes peut rebuter les non-initiés, mais les commandes Git se maîtrisent rapidement.

Chaque système d’exploitation possède sa propre interface en ligne de commandes :

• Windows : l’invite de commandes peut être lancée en utilisant la touche Windows et en tapant Invite de commande (ou cmd) avant de sélectionner l’option dans la liste qui apparaît.
• MacOS : on lance un terminal depuis l’onglet Applications > Utilitaires.
• Linux : généralement, on peut lancer un terminal avec le raccourci clavier Ctrl + Alt + T. Si cela ne fonctionne pas, recherchez Terminal dans les applications ou via les outils de recherche.

Voici à quoi ressemble un terminal :

2- Vous allez maintenant vous placer dans le dossier au sein duquel vous avez enregistré le projet que vous souhaitez importer via la ligne de commande :

cd "chemin/vers/votre/dossier"

Il faudra bien sur remplacer le chemin entre "" par le chemin correspondant à votre dossier sur votre ordinateur.

3- Il faut ensuite lancer Git :

git init

Cette commande permet d’initialiser Git dans le dossier au sein duquel vous vous trouvez. Cela implique que toutes les opérations que vous réaliserez avec Git dans ce dossier seront sauvegardées.

4- Une fois git initialisé, il faut lui indiquer l’URL du dépôt Github au sein duquel vous souhaitez importer vos fichiers et dossiers.

git remote add origin https://github.com/LeCampionG/github_fiche_rzine.git

Cette url est celle indiquée dans la barre d’adresse de votre navigateur lorsque vous êtes connecté.e à Github et dans votre dépôt. Elle est également indiquée dans les premières informations affichées lorsque vous avez créé votre dépôt.

5- Indiquez les fichiers à téléverser dans le dépôt Github

Cela se fait en plusieurs étapes. D’abord il faut spécifier les fichiers à envoyer.

Les commandes suivantes permettent de préciser les éléments à importer :

• git add --all : l’intégralité d’un dossier
• git add rzine_tuto_github.Rmd : un fichier particulier

Dans un second temps, il faut réaliser un commit³, c’est-à-dire une sauvegarde à un instant “t” des différents éléments du dossier et/ou de l’état des fichiers, grâce à la commande git commit.

La commande “-m” suivie d"un texte entre guillemets permet de spécifier le message associé à l’étape d’enregistrement de l’instantané : * git commit -m "1er import des fichiers" * ou simplement -m "un_texte" à la suite d’une commande git commit

6- La dernière étape consiste à rendre tout cela visible et accessible, on parle de pusher⁴ les fichiers :

• git push -u origin master, la commande master pointant vers l’endroit où les fichiers seront téléversés.

Notez que pour valider votre import, il faudra fournir votre identifiant et votre mot de passe.

Une fois toutes ces étapes validées, votre dépôt GitHub contiendra les fichiers que vous aviez en local sur votre ordinateur!

1.8 Les branches

Git et Github permettent de faire des branches⁵ Cela s’avère très utile lorsque l’on travaille à plusieurs ou que des corrections de contenu sont nécessaires.

Dans Gitub, la création de branches peut se faire facilement. Depuis l’accueil de votre dépôt (onglet <> code) cliquez sur le bouton encadré en rouge, dans l’image ci-dessous. Ce bouton permet, entre autres choses, de créer des branches.

Un menu déroulant apparait : pour créer une branche, il suffit d’écrire son nom puis de cliquer sur Create branch.

Cet onget vous indiquera dans quelle branche vous vous trouvez et vous permettra également de naviguer entre les branches.

% ICI JE PENSE QUE L’ON PEUT ETRE PLUS CLAIRS En procédant de cette manière, les branches créées seront des copies des branches depuis lesquelles vous les avez produites. Cela suppose que s’il y a des modification à faire il faut les faire depuis Github ou supprimer un fichier et le ré-importer dans la branche. Ce n’est pas toujours le plus efficace.

La même chose est possible en ligne de commande, et, ce, de manière plus optimisée (même si, nous n’aborderons pas ici toute la complexité et les possibilités de la création de branches avec les fonctions Git).

Pour faciliter la compréhension du principe prenons l’exemple de cette fiche Rzine. Nous avons déposé dans un dépôt Github une première version de nos travaux. Nous souhaitons la faire relire par un collègue, ou y apporter nous-même des modifications sans toutefois écraser la première version. Nous allons donc opérer les différentes modifications en local sur notre ordinateur. Une fois satisfaits, nous allons créer une branche au sein de laquelle nous allons importer les fichiers modifiés sans écraser les premiers travaux. Le très grand intérêt à cela c’est que nous pourrons par la suite comparer les deux branches et éventuellement les fusionner.

Commencez par vous placer dans le bon répertoire (ici le dossier tuto_github localisé dans le répertoire Rzine appartenant lui-même au répertoire gregoire et ainsi de suite) :

cd "/mnt/9A8C6DB98C6D9115/gregoire/Rzine/tuto_github"

Pour créer une nouvelle branche (que nous choisissons ici d’appeler “correction”), il suffit d’écrire :

git checkout -b correction

Notons que le répertoire actif bascule alors automatiquement vers la branche nouvellement créée. Il est alors possible d’importer un fichier ou un dossier dans cette nouvelle branche, en suivante la procédure utilisée en amont pour la branche principale :

• git add rzine_tuto_github.Rmd, pour l’import d’un fichier unique
• git add --all, pour l’import d’un dossier et de l’ensemble des éléments qu’il contient

% je ne comprends pas ce que tu voulais dire ici : Attention, il est nécessaire d’indiquer à Git quel fichiers ont été retravaillés

La commande git status peut être très pratique pour avoir un aperçu des fichiers qui ont subi des modifications.

Comme précédemment, il faut réaliser un commit, qui permettra notamment de voir et prendre en compte toutes les modifications réalisées sur le fichier :

git commit -m 'fichier sur lequel réaliser les modifications'

Les changements réalisés sur la branche annexe “correction”, s’ils sont validés, peuvent être renvoyés du répertoire local vers une branche du dépôt GitHub (ici, la branche d’origine) :

git push origin correction

Notons, enfin, qu’il est aisé de naviguer d’une branche à l’autre grâce à la commande checkout. Ici, on cherche par exemple à retourner sur la branche master, qui correspond au dernier embranchement dans lequel un commit a été effectué :

git checkout master

1.9 Pull requests

Avec la création de branches, vous pouvez donc modifier comme vous le souhaitez un fichier tout en le conservant intact dans une autre branche.

Une fois les corrections, les modifications… terminées, il peut être utile de comparer les différents éléments et fusionner les fichiers modifiés. On peut alors réaliser un pull request (qui recherche les modifications faites dans les répertoires qui se raccrochent à un dépôt et les fusionne).

Github propose une interface graphique intéressante pour réaliser cette opération (elle est bien évidemment aussi faisable en ligne de commande). Pour ce faire, utilisez le bandeau et cliquez sur le bouton Pull requests.

Cliquez sur New pull request pour lancer une nouvelle comparaison :

Il faut désormais choisir les deux branches à comparer :

Une fois le pull réalisé, vous verrez les différences éventuelles entre vos deux branches : les modifications des fichiers similaires, les fichiers présents dans la 2ème branche mais pas la première…

Si cela vous convient, cliquez sur le bouton Create pull request.

Vous pouvez ensuite commenter, décrire votre demande et la soumettre en cliquant sur Create pull request.

Vous avez donc fait une demande qui apparaitra dans votre section Pull requests.

% pas sûre de comprendre ce que tu voulais dire dans la deuxième partie de la phrase? Vous pouvez échanger des pull request de la même manière qu’avec les issues, avec l’avantage que les pull requests permettent de visualiser ce qui sera fusionné.

Si cela vous convient, vous pouvez accepter les modifications en cliquant sur Merge pull request.

Les deux branches sont alors fusionnées.

Il est également possible de refuser un pull request (et donc d’ignorer les modifications de fichiers associées) en cliquant sur Close pull request